Context

This PR implements a YAML-based configuration system for custom modes, providing a more structured way for users to define custom modes and improving the developer experience.

Design Doc: https://hackmd.io/@upamune/roo-rule-directory

Implementation

The implementation includes:

1. Zod Schema for Mode Configuration: Added src/modeSchemas.ts to implement Zod schemas for mode configurations, enabling type-safe configurations.

2. JSON Schema Generation Script: Added scripts/generate-mode-schema.ts to generate JSON schema from Zod schema, enabling auto-completion and validation when editing YAML files in editors.

3. Mode Configuration Service: Implemented src/services/ModeConfigService.ts to provide functionality for loading, saving, and managing mode configurations from both global and project-specific locations.

4. Legacy Support: Maintained backward compatibility with existing .roomodes file format.

5. Syntax Extensions: Added support for both V1 (tuple-based) and V2 (object-based) syntax, providing more flexible configuration options.

6. Dependencies: Added js-yaml and zod-to-json-schema to support YAML file processing and JSON schema generation.

Screenshots

How to Test

1. Create a .roo/modes/ directory and define a custom mode with a YAML file
2. Define a mode with the following format:

name: Example Mode
roleDefinition: You are a specialized assistant for example tasks.
groups:
  - read
  - edit:
      fileRegex: /\.md$/
      description: Markdown files
  - command

3. Restart VSCode and verify that the new mode is available
4. If you have an existing .roomodes file, verify that those modes are still available

Get in Touch

Discord: @serizawa_